Cream of the Crop 1

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / 4PRINT41.ARJ / ADDENDUM.DOC < prev next >

Wrap

Text File | 1991-08-20 | 87KB | 2,127 lines

▄ TM ▄ ▄ █ █ █▀▀█ ▀ █ █ █ ▀█ █▄▄█▄ █▄▄█ █▀▀█ █ █▀▀█ ▀█▀ █▄▄█▄ █ █ █ █ █ █ █ █ █ █ ▀ ▀ ▀ ▀ ▀ ▀ ▀▀ ▀ ▀ ▀▀▀ █▀▀▀█ █ █ █ █▄▄▄█ █▀▀█ █▀▀█ █▀▀█ █▀▀█ █▀▀█ █ █ █▀█▀█ █ █ █ █ █ █ █▀▀▀ █ █ █ █ █ █ █ █ █ ▀ ▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀ ▀ ▀▀▀▀ ▀▀▀▀ ▀ ▀ ▀ and ▄ TM █ █ █▀▀█ █ █ █▄▄█▄ █▀▀▀█ █▀▀█ █▀▀█ █▄█▄ █ █ █ █ █ █ █ █ █ ▀ ▀▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀ ▀ █ █ ▄ █▀▀▀▀ ▀ █ █ █ █▀▀ █▀▀█ █▀▀█ ▀ █▀▀ █ ▄▄ █ █ █ █▀▀█ █▀▀█ █ █ ▀▀█ █▀▀▀ █ ▀▀█ █ █ █ █ █ █ █ █▀▀▀ ▀▀▀▀ ▀▀▀ ▀▀▀▀ ▀ ▀▀▀ ▀▀▀▀▀ ▀▀▀▀ ▀ ▀▀▀▀ ▀▀▀▀ Copyright 1991 by Korenthal Associates, Inc. All Rights Reserved ┌─────────┐ ┌─────┴───┐ │ (R) ──│ │o │────────────────── │ ┌─────┴╨──┐ │ Association of │ │ │─┘ Shareware └───│ o │ Professionals ──────│ ║ │──────────────────── └────╨────┘ MEMBER ────────────────────────────────────────────────────────────────────── Credits 4Print and 4Book were written by James E. Korenthal, Lewis Horowitz, Steven E. Arnott, and Tracey M. Siesser. ────────────────────────────────────────────────────────────────────── Copyright Notice 4Print and 4Book are Copyright 1991 by Korenthal Associates, Inc. All rights are reserved. This document is Copyright 1991 by Korenthal Associates, Inc. All rights are reserved. ────────────────────────────────────────────────────────────────────── Trademarks 4Print, 4Book and Babble! are trademarks of Korenthal Associates, Inc. All trademarks and registered trademarks referenced within this document are the property of their respective holders. ────────────────────────────────────────────────────────────────────── Warranty Disclaimer KORENTHAL ASSOCIATES, INC. MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY WARRANTIES OF MERCHANTABILI- TY AND/OR FITNESS FOR A PARTICULAR PURPOSE. KORENTHAL ASSOCIATES, INC. DOES NOT ASSUME ANY LIABILITY FOR THE USE OF THIS SOFTWARE BEYOND THE ORIGINAL PURCHASE PRICE OF THIS SOFTWARE. IN NO EVENT WILL KORENTHAL ASSOCIATES, INC. BE LIABLE TO YOU FOR ANY ADDITIONAL DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OF, OR INABILITY TO USE, THIS SOFTWARE AND ITS ACCOMPANYING DOCUMENTATION, EVEN IF KORENTHAL ASSOCIATES, INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Table of Contents ────────────────────────────────────────────────────────────────────── New to Version 4.1 . . . . . . . . . . . . . . . . . . . . . . . 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 1 Bug Fix: Word Wrap with Line Numbering . . . . . . . . . . . . 1 Memory Utilization . . . . . . . . . . . . . . . . . . . . . . 1 Advanced Paper Handling Features . . . . . . . . . . . . . . . 2 Ignoring Form Feeds: The -ZF Option . . . . . . . . . . . . . 3 DeskJet Letter Quality: The -DJL Option . . . . . . . . . . . 4 Pausing Before Exit: The -PAUSE Option . . . . . . . . . . . . 4 Getting Help: The -HELP, -?, and ? Options . . . . . . . . . . 4 4Print Option Defaults . . . . . . . . . . . . . . . . . . . . 5 Additional Environment Variable: _4PRINT . . . . . . . . . . . 5 Zapping the Watermark: The -ZW Option . . . . . . . . . . . . 5 4Book User's Guide . . . . . . . . . . . . . . . . . . . . . . . 7 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 7 Installation . . . . . . . . . . . . . . . . . . . . . . . . . 7 Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . 7 4Book Operation . . . . . . . . . . . . . . . . . . . . . . . 8 The 4Book Command Line . . . . . . . . . . . . . . . . . . 8 The 4Book Environment Variable . . . . . . . . . . . . . . 9 4Book Configuration Files . . . . . . . . . . . . . . . . 9 Finding Files . . . . . . . . . . . . . . . . . . . . . . 9 Cover Styles: The -BC Options . . . . . . . . . . . . . . . . 10 Basic Styles . . . . . . . . . . . . . . . . . . . . . . . 10 Variations . . . . . . . . . . . . . . . . . . . . . . . . 11 Cover Titles: The -BT Option (and More -BC Options) . . . . . 11 Specifying Your Own Cover Title . . . . . . . . . . . . . 11 Shadings and Special Effects . . . . . . . . . . . . . . . 12 The Cover Control String . . . . . . . . . . . . . . . . . . . 12 Footer Text and Page Numbering Styles: The -BF and -BN Options 13 Footer Text . . . . . . . . . . . . . . . . . . . . . . . 13 Page Numbering Styles . . . . . . . . . . . . . . . . . . 14 Expanded Page Numbering . . . . . . . . . . . . . . . . . 14 More About Configuration Files: Options and Boilerplate Text . 15 4Book Options . . . . . . . . . . . . . . . . . . . . . . 16 Boilerplate Text . . . . . . . . . . . . . . . . . . . . . 16 Ignoring Default Configuration Files: The -NOCFG Switch . 18 Other 4Book Options . . . . . . . . . . . . . . . . . . . . . 19 Printing in Reverse Page Order: the -R and -RF Switches . 20 ────────────────────────────────────────────────────────────────────── Table of Contents i Don't "Squash" the Font!: the -SQ- Switch . . . . . . . . 20 Duplex Printing: the -D Switch . . . . . . . . . . . . . . 21 Unattended Operation: the -BU Switch . . . . . . . . . . . 21 Bypassing End-Of-File Characters: the -Z Switch . . . . . 21 Appendix F: Additional Trouble-Shooting Guide . . . . . . . . . . 23 Appendix G: Using 4Print With Legal Size Paper . . . . . . . . . 26 Appendix H: Using 4Print With DESQview . . . . . . . . . . . . . 28 Appendix I: Real Life 4Book Example . . . . . . . . . . . . . . . 30 Appendix J: 4Shell and 4Script . . . . . . . . . . . . . . . . . 33 ────────────────────────────────────────────────────────────────────── ii 4Print 4.1 Addendum New to Version 4.1 ────────────────────────────────────────────────────────────────────── Introduction This document is an Addendum to the 4Print 4.0 User's Guide. It contains information about changes and new features available with 4Print 4.1, as well as additional trouble-shooting information. New features include various reverse-order printing options to make sure you never have to shuffle the order of pages again, and an option to suppress the KA watermark on the lower right of the page. The Addendum also contains the complete User's Guide for 4Book, 4Print's new booklet-printing utility. 4Book goes way beyond other booklet-printing programs in its configurability and the attractive- ness of the booklets it produces. This Addendum sometimes refers to appendices contained in the 4Print User's Guide as well as the Addendum's own appendices. Please note that Appendices A-E can be found in the main 4Print User's Guide, while Appendices F-J can be found right here. ────────────────────────────────────────────────────────────────────── Bug Fix: Word Wrap with Line Numbering Under certain circumstances, specifying a word wrap option such as "-ww" or "-wp" along with line numbering, "-n", could cause 4Print to go into an infinite loop. Note that this only happened in version 4.0, and was fixed in interim version 4.01. 4Print 4.1 also incorpo- rates the bug fix. ────────────────────────────────────────────────────────────────────── Memory Utilization 4Print 4.0 and interim versions through 4.05 had very little free working storage available once the program started running. In rare cases, this caused 4Print to abort with Fatal Error number 204, regardless of how much free memory you had on your computer when 4Print ran. 4Print 4.1 doubles the free memory available to 4Print, and should eliminate most, if not all, possibility of memory overflow. ────────────────────────────────────────────────────────────────────── New to Version 4.1 1 ────────────────────────────────────────────────────────────────────── Printing in Reverse Page Order: the -R and -RF Switches 4Print and 4Book now have advanced paper handling features which will allow you to obtain perfectly collated, double-sided printouts without manually shuffling any pages, even on non-duplex printers. See the section entitled "Advanced Paper Handling Features" for information about using these options. ────────────────────────────────────────────────────────────────────── Advanced Paper Handling Features ┌────────────────────────────────────────────────────────┐ │ Note: If you have a duplex printer such as the IID, │█ │ IIID, or IIISi with the duplex option, this section │█ │ does not apply to you. Use your printer's duplex │█ │ capability for all double-sided printing by specifying │█ │ the "-d" or "-ds" option in both 4Print and 4Book. │█ │ │█ └────────────────────────────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ When you are printing double-sided documents on a non-duplex printer, 4Print and 4Book first print the front side, then require you to reinsert the stack of pages into the printer before printing the back side. Previous versions of 4Print only printed the back side in one order, requiring manual shuffling of the pages on some printers. New to 4Print Version 4.1 and also included in 4Book are two options which, when used correctly, completely eliminate the need for all paper shuffling, either before printing the reverse side or after the final document is printed. These options are "-r" (reverse print back side) and "-rf" (reverse print front side). Once you determine which combination of options (you may need neither, one, or both) applies to your printer, you can put them in the 4PRINT environment variable and they will assure you of hassle-free 4Print and 4Book runs every time. We have included a file called TESTPRIN.BAT on the 4Print distribution disk which will automatically determine the set of options appropriate to your needs. To run the batch file, simply make sure your printer is online and type TESTPRIN at the DOS prompt. You can determine which options will be needed for your printer (and your output tray choice, if more than one is available) without running TESTPRIN.BAT. Note that in the following paragraphs, the "top" of the page refers to the side of the page facing you as you look down on the input tray. If your printer prints on the top of the page and stacks its output in reverse order, you do not need to specify any paper handling options ────────────────────────────────────────────────────────────────────── 2 4Print 4.1 Addendum to 4Print or 4Book. This is typical of the LaserJet II or III with the output going to the rear tray. If your printer prints on the top of the page and stacks its output in correct order, you need the "-r" switch in 4Print and 4Book. This is typical of the II or III with the output going to the top tray. If your printer prints on the bottom of the page and stacks its output in reverse order, you need the "-rf" switch in 4Print and 4Book. This is typical of the DeskJet or of the IIP or IIIP with the optional output tray. If your printer prints on the bottom of the page and stacks its output in correct order, you need both switches ("-r -rf") in 4Print and 4Book. This is typical of the IIP and IIIP without the optional output tray. Note that 4Print implements the "-r" and "-rf" options by creating a temporary file during its normal operation, and then printing the pages in correct sequence from this temporary file. This means you must have enough free disk space to accommodate the temporary file. (The file is automatically deleted when 4Print exits.) Also, the temporary file is created in your current working directory unless you have a 4TEMP, TEMP, or TMPDIR environment variable set. For example, if your AUTOEXEC.BAT file contains the line "SET 4TEMP=D:", 4Print (and 4Book) will use your D: drive for any temporary files it creates. The reverse print phase is very fast in 4Print, but you can make it even faster by specifying a RAM disk for temporary files. ────────────────────────────────────────────────────────────────────── Ignoring Form Feeds: The -ZF Option This option causes 4Print to completely ignore all form feeds in your document. We have no idea why this option is useful, but Ron VanAbrahams asked for it and since he's been such a good beta tester and has contributed quite a bit to this release (including most of the SAYINGS.TXT file for 4Book), we couldn't refuse without appearing to be incredibly ungrateful. So there you have it, an option which seems totally useless, but what the heck, it was easy to implement and it makes Ron happy. Seriously: See also the "-xf" option, which runs pages together just as "-zf" does, but adds a line of dashes so you know where the page breaks in the document occur. C>4Print myfile -zf Make Ron happy. Oops, we mean ignore form feeds in the document. ────────────────────────────────────────────────────────────────────── New to Version 4.1 3 ────────────────────────────────────────────────────────────────────── DeskJet Letter Quality: The -DJL Option Starting with version 4.1, 4Print automatically prints in DeskJet draft mode when the "-dj" option is used. This method of printing is more than twice as fast as letter quality printing, and the resulting printout is adequate for most people's text file printing needs. If you wish to use the DeskJet's letter quality mode with 4Print, specify "-djl" instead of "-dj". C>4Print myfile -djl Print the file on a DeskJet, using letter quality mode. ────────────────────────────────────────────────────────────────────── Pausing Before Exit: The -PAUSE Option The "-pause" option causes 4Print to stop for one keypress before returning to your operating system. This guarantees that you'll see the full information from 4Print (such as a possible error message) before your operating system clears the screen. C>4Print myfile -pause Print the file and pause before exiting. Note that this option is not necessary for normal DOS use, but can come in handy if 4Print will be returning to an environment which immediately clears the screen, such as Windows. Note also that if you use 4Shell, the Windows interface to 4Print written by ZPAY Payroll Systems, you should be sure to configure 4Shell to use 4Print 4.1 conventions because, in this case, 4Shell automatically provides a "-pause" on all 4Print runs. ────────────────────────────────────────────────────────────────────── Getting Help: The -HELP, -?, and ? Options Users of versions of 4Print prior to 4.1 know that typing "4print" alone on the command line will yield a rather cryptic summary screen of 4Print's command line options. 4Print's online help information has been greatly expanded with version 4.1, and in addition to help being offered when no parameters are present, 4Print will enter its help system when "4print -help", "4print -?", or "4print ?" are typed. C>4print C>4print -help C>4print -? C>4print ? Enter the help system. (All of these are equivalent.) ────────────────────────────────────────────────────────────────────── 4 4Print 4.1 Addendum Note that in versions prior to 4.1, "4print ?" would attempt to print all files with a name consisting of a single character. You can still accomplish this in version 4.1 by adding a zero-character extension (in other words, just the dot) and typing "4PRINT ?." The help system offers an introductory screen, the one-screen command line summary, a screen of typical 4Print invocation examples, and then 15 screens of detailed information about 4Print command line options. You can move among the screens by pressing <Enter> or the space bar, <PgDn> or <Down Arrow> to go forward, and <PgUp> or <Up Arrow> to go backward. In addition, pressing <Home> or <End> will immediately move you to the first or last screen, respectively. Press <Esc> to exit the help system and return to DOS. ────────────────────────────────────────────────────────────────────── 4Print Option Defaults Depending on which 4Print package you received, you either have information about changing 4Print's defaults using a DOS debugger, or you were provided with a program called KAZAP which changes defaults automatically. In either case, you can follow the information provid- ed in the documentation you received with one important exception: The file containing the 4Print option defaults is now 4PRINT.OVL (instead of 4PRINT.EXE). Follow the instructions you have for changing the defaults, but substitute 4PRINT.OVL wherever 4PRINT.EXE is mentioned. ────────────────────────────────────────────────────────────────────── Additional Environment Variable: _4PRINT This section is only of interest to advanced DOS batch file writers. Instead of the "4PRINT" environment variable described in the User's Guide, you may use the name "_4PRINT" (adding an underscore to the front of the name). 4Print will look for the "_4PRINT" variable only if it doesn't find "4PRINT", and will treat them equivalently. The reason for providing the "_4PRINT" variable is to allow batch files to refer to "%_4PRINT%" without getting confused with command line parameter %4. ────────────────────────────────────────────────────────────────────── Zapping the Watermark: The -ZW Option Have you ever noticed that funny little "KA 4PRINT" logo which appears in the lower right hand corner of all your 4Print printouts? Of course you've noticed it, and c'mon, admit it, you always thought it was kind of cute. Everyone thought it was cute, except perhaps for that one fellow who ranted and raved about how amateurish it was for ────────────────────────────────────────────────────────────────────── New to Version 4.1 5 us to feed our ego by putting our symbol on every one of *his* pre- cious printouts. Aw shucks, we didn't think we were being narcissis- tic; our intent was to provide a "watermark" which would make 4Print printouts more distinctive and classy! But... Enter 4Book. We did a lot of soul searching when we generated the first 4Book test printouts and saw how useful they'd be for small, ad-hoc publishing efforts such as "quickie" club or church newsletters and the like. The watermark, however, seemed quite jarring in this context, espe- cially considering it appeared on *every other* page of a 4Book! Since 4Book calls 4Print to do its printing, we couldn't remove the watermark from only 4Book runs without doing some very sneaky program- ming stuff, so we decided, what the heck, we'll provide an option to get rid of the watermark in 4Print, and we'll let our users decide whether they want to let the watermark print or not. So... C>4print myfile -zw Print the file, suppressing the watermark and bringing just a bit of a tear to the eyes of the KA staff. ────────────────────────────────────────────────────────────────────── 6 4Print 4.1 Addendum 4Book User's Guide ────────────────────────────────────────────────────────────────────── Introduction 4Book is a new companion to 4Print which makes it easy to produce handsome booklets right out of your laser printer. 4Book rearranges the order in which the pages in your document are printed by 4Print so the sheets can be folded in half to form a 5½" by 8½" booklet, or cut in half and inserted into an IBM-style binder. Booklets can be cus- tomized in dozens of ways, including cover styles, large title fonts, boilerplate text, and even random quotes that print out differently each time the booklet is printed. ┌─────────────────────────────────────────────────────────┐ │ Tip: Please note that you MUST have 4Print version 4.0 │█ │ or later to use 4Book! 4Book WILL NOT WORK with any │█ │ earlier version of 4Print! │█ │ │█ └─────────────────────────────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ────────────────────────────────────────────────────────────────────── Installation Since 4Book accompanies 4Print 4.1, it should have been installed along with 4Print. If not, or if it was accidentally erased, just copy the 4BOOK.EXE, 4BOOK.CFG, and SAYINGS.TXT files from the distri- bution disk to the directory which contains 4PRINT.EXE. See the 4Print User's Guide for detailed instructions and examples. ────────────────────────────────────────────────────────────────────── Quick Start To get started with 4Book, type the following at the DOS prompt: C>4book 4Book will display the first of seven screens of help information. These screens contain usage instructions and a complete list of ────────────────────────────────────────────────────────────────────── 4Book User's Guide 7 4Book's options. Press <PgUp> and <PgDn> to move from one help screen to another, and press <Esc> to return to DOS. To get a feel for what 4Book does, try creating a booklet using a small text file. To print the README.DOC file that comes on the 4Print distribution disk, for example, type: C>4book readme.doc or C>4book readme.doc -d if you're using a duplex printer or C>4book readme.doc -dj if you're using a DeskJet The program will scan the file, and then pause and prompt you to press "Y" to print the booklet. 4Book will then call 4Print with the name of the file and any options you've specified. Unless you have a duplex printer (such as a IID or IIID) and have included the "-d" option on the command line, 4Print will print the front side, and then pause and ask you to reinsert the paper into the paper tray to print the reverse side. ────────────────────────────────────────────────────────────────────── 4Book Operation 4Book is a pre-processor for 4Print. 4Book scans your document, determines where the page breaks occur, and creates a temporary file containing the pages of the document in the proper order for printing a booklet. 4Book tells you how many pages the booklet will contain, and pauses to allow you to decide whether or not to continue. If you press "Y", 4Book will call 4Print with the name of the temporary file and any options which it does not recognize as 4Book options. You can tell 4Book to pass an option straight through to 4Print by prefacing it with "--". For example, "--m" will tell 4Print to put the printer in manual mode before printing the reverse side. Options may be passed to 4Book in three ways. You may specify options by typing them on the 4Book command line, by setting an environment variable called "4BOOK", or by including them in a configuration file. The 4Book Command Line ────────────────────── You can follow the 4Book command with the name of the file to be printed, and any number of 4Book/4Print options (also known as "switches") in any order. Options must start with a dash or a slash, and must be surrounded by spaces. Options may not be combined with a single dash or slash. 4Book will process any options which it recognizes, and pass everything else through to 4Print. In addition, you may preface a 4Print option with "--", and 4Book will pass it straight through. ────────────────────────────────────────────────────────────────────── 8 4Print 4.1 Addendum Since 4Book doesn't "know" what a valid 4Print option is, it can't catch any errors. It will, however, tell you what it is about to pass to 4Print when it requests your permission to continue after scanning the document. If you notice any errors, press "N" to cancel the print job, and retype the command. The 4Book Environment Variable ────────────────────────────── You may specify any or all 4Book options in the DOS environment instead of (or in addition to) the 4Book command line. 4Book will consider any information found in the "4BOOK" environment variable as if it were attached to the BEGINNING of the command line. You may want to set the 4Book environment variable in your AUTOEXEC.BAT file if there are certain options that you always want to use with 4Book. For example, suppose you typed this command (or put the command in your AUTOEXEC file) any time before you invoked 4Book: C>set 4book=-bcBook Note that there CANNOT be a space after the word "4book" or after the equals sign, and that there is a dash in the "-bcBook", just as if it were on the 4Book command line. Given the above environment setting, any subsequent 4Book run would use the "Book" cover style (inside covers guaranteed). 4Book Configuration Files ───────────────────────── 4Book will read options and boilerplate text from one or more configuration files. The default configuration file is 4BOOK.CFG. 4Book will search for this file every time it is invoked. See "Finding Files" below for further details. You can tell 4Book to process additional configuration and boiler- plate files on the command line or in the environment: + Configuration options and boilerplate text are in the document itself. +<filename> Read additional options and boilerplate text from <filename>. Configuration and boilerplate files provide you with a great deal of flexibility in customizing the layout and appearance of your booklets. See "More About Configuration Files: Options and Boiler- plate Text" for detailed instructions on using these files. Finding Files ───────────── 4Book must be able to find the 4Print executable file, 4PRINT.EXE. When 4Book tries to call 4Print, it first searches the current directory. If you are using DOS 3.3 or above, it then searches the ────────────────────────────────────────────────────────────────────── 4Book User's Guide 9 directory from which 4Book was executed. Finally, it searches the directories contained in the DOS path. 4Book uses this same logic when trying to find configuration files, or "#include" files or "#random" files. See "More About Configura- tion Files: Options and Boilerplate Text" for more information on using these files. ────────────────────────────────────────────────────────────────────── Cover Styles: The -BC Options 4Book sports a wealth of cover style options, allowing you to specify everything from which parts of the cover print to which frame lines you want to surround the booklet title. Basic Styles ──────────── 4Book has four basic cover styles as well as an option to suppress the covers entirely. Each style lets you specify a different com- bination of inside and outside covers. Use the diagram below to determine which combination of inside and outside covers you need, and then select an option correspondingly. ┌─────────┬─────────┐ ┌─────────┬─────────┐ │ │ ╔═════╗ │ │ │ │ │ │ ║TITLE║ │ │ │ │ │ back │ ║ ON ║ │ │ front │ back │ │ outside │ ║FRONT║ │ │ inside │ inside │ │ │ ║ ║ │ │ │ │ │ │ ╚═════╝ │ │ │ │ └─────────┴─────────┘ └─────────┴─────────┘ The Outside Cover The Inside Cover -bcBook Front and back inside and outside covers guaranteed. -bcFacing Front and back outside covers, front inside cover (first page of text starts on the right-hand side). -bcCompact Front and back outside covers only. -bcMin Front outside cover only. -bc- No covers. The document is the entire booklet. Both "-bcBook" and "-bcFacing" will print odd-numbered pages on the right and even-numbered pages on the left, as they would appear in an actual book. If you don't specify a cover style, 4Book will print front and back outside covers, and a front inside cover (same as "-bcFacing"). The first page of text will appear on the right-hand side. ────────────────────────────────────────────────────────────────────── 10 4Print 4.1 Addendum Variations ┌───────────┐ ────────── │ ╔═══════╗ │ In addition to specifying which covers │ ║ ═════ <─── Horiz. you want, 4Book allows you to change the │ ║ TITLE ║ │ Lines appearance of the covers, including frame │ ║ ═════ ║ │ lines, titles, and shadows, by using one │ ║ ║ │ or more of the following options: │ ║ ║<── Frame │ ╚═══════╝ │ └───────────┘ -bcVanilla Eliminates reversal of the back cover title. -bcBareBack Makes back cover (if present) completely blank. -bcNoFrame Eliminates frames on front and back covers. -bcLines Adds horizontal lines around large cover titles. -bcNoFooter Eliminates duplication of footer line on cover. -bcNoTitle Eliminates large titles on both covers. -bcNoBackTitle Eliminates large title on the back cover only. -bcNoShadow Eliminates "shadow" effect on large titles. ────────────────────────────────────────────────────────────────────── Cover Titles: The -BT Option (and More -BC Options) To complement 4Book's many cover style options, 4Book also offers complete customization of how information on the cover should appear. You can specify the text of the title, which is rendered in a large "font" created from the extended ASCII line drawing characters, as well as select from various "special effects" to lend your document appropriate pizazz. Specifying Your Own Cover Title ─────────────────────────────── By default, 4Book uses the document's file name and extension as the cover title. The file name is printed on the first line, and the file extension on the second line. You may specify your own cover title using the "-bt" option as follows: -bt"Line1//Line2//Line3" Each line can contain a maximum of nine letters, and will be printed in upper case. If the title does not contain any spaces, you need not enclose it in quotes (i.e. -btLine1//Line2//Line3). To suppress the printing of a title on the cover, use the "-bt" option without specifying any title text. For example: -bt No title. -bt4BOOK Prints 4BOOK on line 1, followed by two blank lines. -bt"THIS IS//MY//BOOKLET" Prints THIS IS on line 1, MY on line 2, and BOOKLET on line 3. ────────────────────────────────────────────────────────────────────── 4Book User's Guide 11 Shadings and Special Effects ──────────────────────────── By default, 4Book prints front cover titles in solid black, and back cover titles with a light shading. You can change the shad- ings used and create some fancy special effects by using one of the following options: -bcVeryLight Lightest shading on the front cover. -bcLight Light shading. -bcDark Darker shading. -bcBlack Front and back covers both use black. -bcSunrise Sunrise special effect on front cover. -bcSunset Sunset special effect on front cover. -bcSunburst Sunburst special effect on front cover. -bcEclipse Eclipse special effect on front cover. -bcSunspots Sunspots special effect on front cover. -bcYecch Special effect which we think looks ugly, but may appeal to some people. <grin> -bcBackwards Front and back titles reversed horizontally. -bcUpside-down Front and back titles reversed vertically. ────────────────────────────────────────────────────────────────────── The Cover Control String As 4Book scans the command line, environment variable and configura- tion files, it creates an 18-character cover control string. Each of the "-bc" options described above affects the contents of one or more character positions in the string. When all of the options have been read, 4Book uses the resulting cover control string to determine the characteristics of the booklet covers. You can directly specify the cover style and any number of cover style variations by following "-bc" with the exact cover control string to be used. In addition to shortening the command line, using the cover control string allows you to apply cover style variations to either the front or the back cover. Otherwise, most specified variations are applied to both the front and back covers. Front Back ┌───┴───┐┌───┴───┐ 123456789123456789 "------------------" Pos Option Description Option Specifier --------------------------------------------------------------- 1 Print front (back) cover? Y or 1 for yes, N or 0 for no, B or 2 for yes+inside cover 2 Print frame? Y for yes, N for no 3 Print horizontal lines? Y for yes, N for no ────────────────────────────────────────────────────────────────────── 12 4Print 4.1 Addendum 4 Print footer text under Y for yes, N for no large title? 5 Print large title? Y for yes, N for no 6 Gray level of title 0 Very Light 5 Sunrise 1 Light 6 Sunburst 2 Dark 7 Eclipse 3 Black 8 Sunspots 4 Sunset 9 "Yecch" 7 Shadow on title? Y for yes, N for no 8 Reverse title horizontally? Y for yes, N for no 9 Reverse title vertically? Y for yes, N for no ┌───────────────────────────────────────────────────────────────────┐ │ Tip: Printing a Cover Separately From the Text │█ │ │█ │ There may be times when you'd like to print the cover separate- │█ │ ly from the text. For example, you may want to print the cover │█ │ on a different stock of paper. You can do this with 4Book by │█ │ breaking the print job into two steps. │█ │ │█ │ First, print the booklet using the "-bc-" option to suppress │█ │ the printing of a cover. Next, tell 4Book to take its input │█ │ from the "NUL" DOS device (which generates an immediate end-of- │█ │ file), and specify a custom title and footer: │█ │ │█ │ C>4book nul -btMY//BOOKLET -bf"Copyright 1991" │█ │ │█ │ 4Print will print a cover without any accompanying document. │█ │ (See "Footer Text and Page Numbering Styles" below for details │█ │ on specifying a footer text line. │█ │ │█ └───────────────────────────────────────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ────────────────────────────────────────────────────────────────────── Footer Text and Page Numbering Styles: The -BF and -BN Options As with everything else, 4Book has many options for specifying footer and page number information. Footer Text ─────────── By default, 4Book prints the document's file name and extension beneath titles and at the bottom of each page of text. You may eliminate the footer line or the footer text, or specify the footer text to be printed by using one of the following options: ────────────────────────────────────────────────────────────────────── 4Book User's Guide 13 -bf- Footer line is entirely eliminated. -bf Footer text is blank; footer prints as a solid horizontal line. -bf"Text" Footer text is as specified. If the footer text you've specified does not contain any blanks, you do not need to enclose it in quotes (e.g. -bfProposal). If you want to include double quotes in the text, enclose the footer text in single quotes instead of double quotes (e.g. -bf'Special "Sun- rise" Effect'). Page Numbering Styles ───────────────────── 4Book has two different page numbering styles, and an option to suppress the printing of page numbers. You select the style to be used by specifying one of the following options: -bn- No page numbering. -bn1 Just the page number is printed. -bn2 "Page n" is printed, where n is the page number. Please keep in mind that page numbering works in conjunction with the specified footer text style. If you've used the "-bf-" option to eliminate the footer line, page numbers are automatically elim- inated also. If you want page numbers without footer text, use the "-bf" option to eliminate the footer text without eliminating the footer line. Expanded Page Numbering ─────────────────────── For the purpose of printing page numbers, 4Book allows you to divide your document into four parts. The first part is printed without page numbers. This part might be a custom cover (not a 4Book cover), followed by a credits page, for example. The second part is printed using lower-case Roman numerals as page numbers. This might be the Table of Contents or the Preface. The third part is printed without page numbers. This might be a series of one or more blank pages before the first page of Chapter 1. Finally, the remainder of the document will be printed with decimal numbers. To use expanded page numbering, specify the "-bn" option, followed by the style code (1 or 2), followed by one or more of the follow- ing parameters: Start Number to be printed on first decimally numbered page. None1 Number of initial pages with no page numbering. Roman Number of pages after initial pages with small Roman numerals. None2 Number of pages after Roman pages with no numbering. Each parameter is a decimal number; any parameter may be omitted by using a comma to hold its place (see example "-bn1,,,3" below). ────────────────────────────────────────────────────────────────────── 14 4Print 4.1 Addendum The "Start" parameter holds the decimal number which will be printed on the first decimally numbered page, as determined by the "None1", "Roman" and "None2" parameters, if any. You can separate the "parts" of your document with one or more blank pages by preceding the "None1" and/or "None2" parameters with a dash. 4Book will insert the specified number of form feed char- acters into the document to force the desired page breaks. This can be used to force a page which would have appeared on the left to be printed on the right. "-None1" and "-None2" also have associated boilerplate tags called ".blank1" and ".blank2". Any text following these tags will be printed on the blank pages created by using this option. Please note that blank pages which are created by using "-None1" or "-None2" will not contain a footer line, while blank pages which are part of your document will. Examples: -bn2,10,2,2,1 Use "Page n" numbering style. The first two pages have no page numbers, followed by two that use Roman numerals, followed by a page with no page number, followed by "Page 10". (Note that "Page 10" is actually the sixth page in the document.) -bn1,,,3 The page number is just the number itself. The first three pages use Roman numerals. The re- maining pages use decimal numbers, starting with "1". -bn1,,,3,-1 Same as above, except that a blank page will be inserted between the last page that uses Roman numerals and the remainder of the document. ────────────────────────────────────────────────────────────────────── More About Configuration Files: Options and Boilerplate Text 4Book's configuration files help you to both standardize and customize the appearance of your booklets. You standardize them by including options which you want to use for all (or most) of them, and customize them by including boilerplate text to be printed on the covers or on blank pages within your document. 4Book always searches for 4BOOK.CFG before any additional configura- tion and boilerplate files. Options contained in additional config- uration files are *added* to those contained in 4BOOK.CFG, while boilerplate files are *substituted* for any boilerplate text contained in 4BOOK.CFG. To avoid confusion as to which configuration files have ────────────────────────────────────────────────────────────────────── 4Book User's Guide 15 been processed, 4Book will display the name of any and all configura- tion files which it has read after scanning the document. 4Book Options ───────────── Configuration files may contain both 4Book and 4Print options. Option lines must start with ".options", followed by one or more spaces and the options themselves. A configuration file may con- tain any number of option lines, and they may appear anywhere within the file. For example: .options -bcBook -btMY//BOOKLET Note that the period in ".options" MUST be in column one of the line! Boilerplate Text ──────────────── You can add text to your document by including one or more of 4Book's boilerplate commands in a configuration file. You may specify the page(s) on which to print the text, and its location on the page, as follows: Pages on Which to Print Text ---------------------------- .front Front outside cover .inside Front inside cover .back inside Back inside cover .back Back outside cover .blank Any blank pages after last page of document .blank1 Any blank pages created by using "-None1" parameter in the "-bn" option .blank2 Any blank pages created by using "-None2" parameter in the "-bn" option See "Expanded Page Numbering" for an explanation of the "-None1" and "-None2" parameters to the "-bn" page numbering option. Positioning Instructions ------------------------ center Center text block in available space top center Center text block horizontally only left center Center text block vertically only right Print text block flush right bottom Print text block at bottom of page bottom right Print text block in bottom right corner block Consider text as a block, and position it based upon the length of the longest line A positioning instruction must be typed on the same line as the "dot command" to which it relates. Any other information on the line is ignored, so make sure that the boilerplate text itself ────────────────────────────────────────────────────────────────────── 16 4Print 4.1 Addendum begins on the line *following* the dot command. Everything up to the next "." is considered part of the boilerplate text. When centering has been requested, 4Book will center each line of text individually. Use the "block" positioning instruction to tell 4Book to consider the text as a block, and center it based upon the length of the longest line in the block. This applies to right justified text as well. Boilerplate lines are simple text, except for the following two special lines: #include <filename> Take text from <filename> before continuing. #random <filename> Choose text randomly from <filename> before continuing. The "#include" directive tells 4Book to simply insert the contents of the specified file into the document before printing the remain- der of the boilerplate text, if any. The "#random" directive tells 4Book to insert a *single* block of text from the specified file. Text blocks are separated by a line which contains a period in column one. The last text block in the file need not be followed by the period delimiter. For example: Never play leapfrog with a unicorn. - Unknown . After a year in therapy, my psychiatrist said to me, "Maybe life isn't for everyone." - Larry Brown . Whenever I'm caught between two evils, I take the one I never tried. - Mae West Here is an example of a 4Book configuration file: .options -bcBook -bcNoHeader .options -btMY//BOOKLET .front center -------------------------- Korenthal Associates, Inc. 230 West 13th Street New York, NY 10011 -------------------------- .inside center #random SAYINGS.TXT .blank pages, top center ----- Notes ----- ────────────────────────────────────────────────────────────────────── 4Book User's Guide 17 A booklet printed using a configuration file containing the above commands would print our company name and address on the front cover, centered in the space beneath the title. It would also print a text block, chosen at random from a file named SAYINGS.TXT, on the inside front cover, and "----- Notes -----" centered at the top of any blank pages which follow the last page of the document. ┌────────────────────────────────────────────────────────────────┐ │ Tip: When you use either "center" or "left center", the text │█ │ may *appear* to be below the center of the page. You can │█ │ compensate for this optical illusion by adding several blank │█ │ lines after the text. 4Book will include these blank lines │█ │ as part of the centered text block, resulting in the actual │█ │ text being shifted upwards. │█ │ │█ └────────────────────────────────────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ┌────────────────────────────────────────────────────────────────┐ │ Tip: 4Book ignores any "dot commands" which it does not │█ │ recognize. This allows you to insert comments in a config- │█ │ uration file by preceding them with something like ".." or │█ │ ".rem". Everything which follows will be ignored, up to │█ │ the next dot command. │█ │ │█ └────────────────────────────────────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Ignoring Default Configuration Files: The -NOCFG Switch ─────────────────────────────────────────────────────── Here's the situation: You have created a 4BOOK.CFG file and placed it somewhere in your DOS path so that 4Book will always process it. However, for the booklet you now want to print, you don't want to use any of the options or boilerplate text contained in 4BOOK.CFG. To prevent 4Book from processing 4BOOK.CFG, you can either rename 4BOOK.CFG to something else, move it to a directory not in your DOS path, or use the "-nocfg" option. When 4Book sees the "-nocfg" option, it removes any configuration files from the command line which it has constructed as of that moment. Since 4BOOK.CFG and any configuration files contained in the "4BOOK" environment variable are treated as if they were at- tached to the *beginning* of the command line, the "-nocfg" option will prevent default configuration files from being processed. On the other hand, configuration files which *follow* the "-nocfg" option *will* be processed. This lets you specify exactly which configuration files, if any, 4Book should use. To clarify all of this, let's look at a few examples: ────────────────────────────────────────────────────────────────────── 18 4Print 4.1 Addendum Example 1 ───────── Scenario: 4BOOK.CFG is in the current directory or in your DOS path, and you don't want to use it for this booklet. Commands: C>4print <filename> -nocfg Example 2 ───────── Scenario: You're working on a network, and 4BOOK.CFG is in a directory contained in everyone's DOS path. You also have a configuration file called MYOPTS.CFG, contain- ing options that only you use, specified in your 4BOOK environment variable. For this booklet, you want to use a configuration file, called SPECIAL.CFG, that is contained in the current directory, instead of the two default configuration files. Commands: C>4print <filename> -nocfg +special.cfg Example 3 ───────── Scenario: Same as Example 2 above, but you only want 4Book to disregard 4BOOK.CFG, while still processing the con- figuration file contained in the environment variable (MYOPTS.CFG). To do this, you add MYOPTS.CFG back to the command line *after* "-nocfg". Commands: C>4print <filename> -nocfg +myopts.cfg +special.cfg As you can see from Example 3, you can use "-nocfg" to "clean the slate", and then specify which con- figuration files you want 4Book to process. ────────────────────────────────────────────────────────────────────── Other 4Book Options Certain 4Book/4Print options should always be used if they apply to you: -a4 Tell 4Print that you're using A4 size (European) paper -dj Specify that you're using a DeskJet printer -d Specify that you're using a duplex printer -z Tell 4Print to ignore EOF characters in your document You may want to consider using other 4Print options with 4Book: -L Take paper from the lower tray -Lu Print the front side using the lower tray, and the reverse side using the upper tray ────────────────────────────────────────────────────────────────────── 4Book User's Guide 19 -m Put the printer into manual mode before printing the re- verse side -n[#] Print line numbers before each line of text -o Re-direct 4Print's output to a device other than PRN -tab# Convert tab characters to the specified number of spaces -u Bypass 4Print's prompts -vc Vertically compress the document -ve Vertically expand the document -x# Print the specified number of copies -zw Zap the "KA 4PRINT" watermark -#n Use the specified soft font -[ Tell 4Print to process the following font selection string Other 4Print options may be useful in certain circumstances. Some may produce undesirable results. Please refer to the 4Print User's Guide for a detailed explanation of these options. In the remainder of this section, we'll describe certain options which you should consider using with 4Book. Printing in Reverse Page Order: the -R and -RF Switches ─────────────────────────────────────────────────────── 4Print and 4Book now have advanced paper handling features which will allow you to obtain perfectly collated, double-sided printouts without manually shuffling any pages, even on non-duplex printers. See the section entitled "Advanced Paper Handling Features" for information about using these options. Don't "Squash" the Font!: the -SQ- Switch ───────────────────────────────────────── One of our goals in creating 4Book was to make it easy to create a document that could be cut in half and placed into an IBM-style 3- ring binder. To prevent the punched holes from overlapping the text, 4Book uses a left indent of 6 spaces. In order to fit 80 characters on a line, 4Book uses a "squashed" font, which slightly reduces the amount of space between each character. If your document doesn't contain any lines which exceed 74 charac- ters, you may reclaim this space by using the "-sq-" option, which tells 4Book not to use the squashed font. ┌────────────────────────────────────────────────────────────────┐ │ Tip: The shareware soft fonts included with 4Print are │█ │ designed to be squashed. See README.DOC for details. │█ │ │█ └────────────────────────────────────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ────────────────────────────────────────────────────────────────────── 20 4Print 4.1 Addendum Duplex Printing: the -D Switch ────────────────────────────── If you have a duplex printer, such as the HP IID or IIID, and use the "-d" option, 4Print will print both sides of the booklet in a single pass by telling the duplex printer to print on both sides of the paper. Since there would never be any reason *not* to use duplex mode, you'll probably want to include the "-d" option in either the 4Book environment variable, or in your 4Book configuration file. Note that you *do not* need to specify the duplex option to 4Book if it is already included in the 4Print environment variable. Unattended Operation: the -BU Switch ──────────────────────────────────── After scanning the input file, 4Book prompts you to confirm that you want to continue. If you'd like to bypass this prompt, use the "-bu" option. Please note that 4Book's "-bu" option is *not* the same as 4Print's "-u" option, which tells 4Print not to pause between printing the front side and printing the back side. ┌────────────────────────────────────────────────────────────────┐ │ Tip: For completely unattended operation on a non-duplex │█ │ printer, add "-bu --u --m" to the 4Book command line. This │█ │ combination of options avoids all 4Book and 4Print prompts │█ │ and puts your printer in manual mode for the reverse side. │█ │ See "Tricky Tip" in the "Unattended Mode: The -U Switch" │█ │ section in Chapter Five of the 4Print User's Guide for a way │█ │ to use the unattended mode and still print both sides using │█ │ the cassette feeder. │█ │ │█ └────────────────────────────────────────────────────────────────┘█ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Bypassing End-Of-File Characters: the -Z Switch ─────────────────────────────────────────────── If a file contains a Ctrl-Z character (Hex 1A or Decimal 26), 4Book considers the file to end just before this character. This is because Ctrl-Z was used in the CP/M operating system to indicate EOF (end-of-file), and many MS-DOS programs still manipulate files using this convention. Most ASCII files won't contain Ctrl-Z characters which mean any- thing other than EOF, but for those few pesky ones which do, use the "-z" option: ────────────────────────────────────────────────────────────────────── 4Book User's Guide 21 C>4book myfile -z The file will be printed to its full DOS file length. Any Ctrl-Z characters in the file will be printed as "?". If 4Book seems to be printing only part of your document, try using the "-z" option. It almost certainly won't hurt (although you might see some garbage at the end of your printout), and it might get your whole document printed. ────────────────────────────────────────────────────────────────────── 22 4Print 4.1 Addendum Appendix F ────────────────────────────────────────────────────────────────────── Additional Trouble-Shooting Guide This appendix should be considered as an adjunct to "Appendix A: Trouble-Shooting Guide" in the main 4Print User's Guide. It contains information about common problems our users have encountered along with suggested solutions. Q: During the scan pass I received an Error 204. What causes this? A: Error 204 is a memory overflow. 4Print's internal buffer can handle approximately 8,000 bytes of data at a time. If, during the processing, 4Print overflows this buffer, this error will occur. First see if you have 160k of free memory on your system to run 4Print. If so, check the document that you are using. Some word processors handle blank lines by filling them with 80 characters of blanks. Either delete these lines or replace them with a carriage return/line feed combination. Q: I was printing to a file with the "-o" option when I received an Error 206 message. What went wrong? A: You did not have enough disk space to complete the process. If you are printing to a floppy disk, use a new one. If you are outputting to a hard disk, check the available disk space. Also, if you use the "-r" or "-rf" options, type SET at the DOS prompt and check to see if you have environment variables TEMP or ────────────────────────────────────────────────────────────────────── Additional Trouble-Shooting Guide 23 TMPDIR specified. 4Print uses these variables to determine where to place its temporary files. It is possible that your TEMP variable specifies a RAM disk of limited size which is overflow- ing; the solution is to type "SET 4TEMP=." at the DOS prompt (or add the line to your AUTOEXEC.BAT) to explicitly tell 4Print to create its temporary files in your default directory. Q: I use 4Print while in DESQview. Every time I 4Print, the page sequence is out of order and I wind up with an extra sheet of paper. What am I doing wrong? A: Please see "Appendix H: Using 4Print with DESQview." Q: I have an HP IIISi printer with PostScript mode as the default. After sending the software string to switch to the PCL printer language I try 4Print but nothing comes out of the printer. A: Check the string that enables the specified language. At the end of the string make sure there is a blank space, followed by a line feed character <LF>. Novell network users with queues for PostScript and PCL languages should have the Network Supervisor try the following: run PRINTDEF In the string enabling the PCL printer language, add a blank space and line feed character <LF>. Q: When I use 4Print with my HP-compatible printer, one to three large vertical bands appear on the output, obscuring the text. A: Some HP-compatibles have trouble interpreting certain PCL com- mands. This particular problem happens because your printer cannot handle graphic commands accurately. Try 4Printing with the "-fn" or "-f=" option. (See "Frame Styles" in Chapter Four of the 4Print User's Guide.) Q: On my HP-compatible, the text fits within the frame but the letters overlap. A: Your printer does not have an internal landscape line printer font. You must either use a cartridge with a landscape line printer font, or download the Letter Gothic font included with this package. See "Fonts and Control Codes" in Chapter Six of the 4Print User's Guide, and refer to README.DOC for instructions on how to download the included fonts. Q: Using 4Print on my HP-compatible with the default settings causes the text to overflow past the frames. ────────────────────────────────────────────────────────────────────── 24 4Print 4.1 Addendum A: Your printer cannot handle Horizontal Motion Index (HMI) codes properly. We have added a switch "-HMI-" to bypass HMI control codes. This will give you the same output as the "-PR" switch but will properly wrap lines of more than 80 characters. Q: Using my HP-compatible, the bottom of my even page output is missing the header information. A: The margins of your printer are smaller than those of the HP LaserJet. Try the "-VC" command line option to compress the vertical size of the 4Print page. Refer to the "Vertical Com- pression" section in Chapter Five of the 4Print User's Guide. As always, if you are experiencing a problem with 4Print, call us at 1-212-242-1790, Mondays through Fridays, between the hours of 10AM and 5PM Eastern time, leave a message in our support forum on CompuServe, PCVENB Section 3, or on The Consultant BBS at 1-718-837-3236. ────────────────────────────────────────────────────────────────────── Additional Trouble-Shooting Guide 25 Appendix G ────────────────────────────────────────────────────────────────────── Using 4Print With Legal Size Paper 4Print was designed to print on letter size or A4 paper. However, if you are willing to do without the frame which 4Print normally draws around your text, you can use legal size (8.5" x 14") paper to print up to 306 characters per line. As 4Print scans your document, it counts the characters in each line. If the number of characters in a line exceeds the number of characters which can be printed in the column (based upon the specified combina- tion of the number of columns, the font size to be used, and whether or not the font will be "squashed"), 4Print will either "wrap" the extra characters onto the next line (the default) or truncate them (if you've used the "-t" option). If you tell 4Print that you are using a proportional font, using the "-pr" option, 4Print is smart enough to realize that it can't deter- mine how many characters will fit on each line, and will simply print as many characters as the line contains. This is the feature we will use to "fake out" 4Print into printing to the end of a legal size sheet of paper. 4Print still thinks that the page is 11 inches long, and will print both the frame and the "KA 4PRINT" watermark where it always does. In order to avoid obscuring your text, you must turn off these two features, using the "-f0" and "-zw" options, respectively. Additionally, the page header will still be printed in the same position, centered on an 11 inch long page. You may want to either suppress the header, or use a custom header that is left-padded with blank spaces. Let's look at some examples. Each of these 4Print command lines will print each line in the document to the end of the line (i.e. until a carriage return character appears). Characters which would otherwise have been "wrapped" onto the next line will now be truncated. The frame will be suppressed, as will the "KA 4PRINT" watermark: ────────────────────────────────────────────────────────────────────── 26 4Print 4.1 Addendum C>4print widefile -pr -f0 -zw Print up to 221 characters on each line, using 4Print's standard line printer font (16.67 characters per inch). C>4print widefile -pr -f0 -zw -tiny Print up to 306 characters on each line, using 4Print's tiny font (23 characters per inch). C>4print widefile -pr -f0 -zw -h Print up to 221 characters on each line, using 4Print's standard line printer font. Suppress the header line. C>4print widefile -pr -f0 -zw -h" WIDEFILE" Same as above, but using a custom header which is left-padded with blank spaces to center the header on a 14" long page. Keep in mind that the paper size setting of your printer is not under 4Print's control. None of these commands will set up your printer to use a different size of paper. You *must* tell your printer that the paper it is printing on is 14" long. You do this either by using a legal-size paper tray, or by changing the menu setting for paper size from the default of LETTER to LEGAL. Consult your printer manual if you don't know how to do this. If you don't set the proper paper size, a paper jam will result! ────────────────────────────────────────────────────────────────────── Using 4Print with Legal Size Paper 27 Appendix H ────────────────────────────────────────────────────────────────────── Using 4Print With DESQview Those using 4Print in DESQview may encounter a problem with an extra page that causes havoc with the 4Print reverse side printing. The following patch, reprinted here with permission from Quarterdeck, should fix the problem. Quarterdeck Technical Note by Stan Young - Patching the DESQview Printer Contention driver to remove the automatic formfeed: Background: One of the features of DESQview 2.+ is the ability to manage printer contention. What this means is that if you are in one window outputting something to the printer and then switch windows and accidentally start a print to the same printer, DESQview Printer Contention will step in and interrupt the second task until the first has finished. Some users will want to have this option on, others will find it not too useful. However, if you have it on, you may notice that you sometimes get extra form- feeds. This is because Printer Contention tries to be sure an application that has done a print has moved the printer to the top of form before allowing another print to occur. Otherwise, you could end up with the second print starting at the bottom of the last page of the previous print. Therefore, Printer Contention sends a formfeed to be sure the printer is a top of form. Since many programs do not close out the printer in a way that Printer Contention can detect that the printer is a top of form, you can end up with a lot of blank, ejected sheets when you use DESQview Printer Contention. Eventually, we may offer some sort of switch to allow the users to select the formfeed option or not, but at present, it is possible to patch the driver to eliminate the formfeed. THE PATCH First, make sure you have a PATH set to your DEBUG.COM file which is part of your DOS files and is usually located in your DOS direc- tory. Switch to the DESQview directory and type in the following to start DEBUG and load the DESQview Printer Contention driver: ────────────────────────────────────────────────────────────────────── 28 4Print 4.1 Addendum C:\DV>debug rmgrdv.dvr After loading, DEBUG returns a minus sign (-) as a prompt. First, we will find the spot where the Printer Contention driver outputs the formfeed. Type in the following: -s0 1000 50 b8 0c 00 <--- Hit <Enter> Debug will display something like the following. The part that is shown as xxxx will be some hex number that we are not concerned with. The number after the colon is the one we are concerned with and may or may not be the "03E2" figure that is shown below. What ever is returned on your machine after the colon on your machine is the number to use. If no such number is returned and you are returned to the "-" prompt, you probably entered something incor- rectly (type q to quit and start again). xxxx:03E2 Type in the following. If the number your machine returned after the colon was different than 03E2, substitute the number returned where it says 03e2 below: -e03e2 You will get a display similar to the one below except the display will be paused after the "50." and will be waiting for input. Type in the "EB" and hit the space bar. Debug will then tab over and display "B8" and again pause for input. Type in "0A" and hit the Enter key. 413C:03E2 50.EB B8.0A ^ ^ <--Type hex numbers starting at carets The "-" prompt will be returned by Debug. Type "w" to write out the change and hit Enter. -w Debug will indicate that it is writing out the change. Writing xxx bytes Type "q" to quit out of Debug. -q You will get the DOS prompt and you are done. Now restart DESQview and you should not get extra formfeeds. ────────────────────────────────────────────────────────────────────── Using 4Print with DESQview 29 Appendix I ────────────────────────────────────────────────────────────────────── Real Life 4Book Example The following example of using 4Book to create a neighborhood associa- tion telephone book was provided by Ron VanAbrahams, who also contrib- uted most of the sayings in the SAYINGS.TXT file included with the 4Print 4.1 package. Many thanks to Ron for all his help. NOTE: This application note assumes you are not a novice com- puter user and have a fair understanding of WordPerfect. There are about 80 members of our Village Association. We have traditionally published a listing of each neighbor's name and address, as well as emergency contact and other vital information; it is updated several times a year. This was a computer-based application even before 4Book came along, but it required a lot of single-sheet feeding into the LaserJet, then stapling and folding in order to make a convenient-sized tele- phone book. 4Book simplifies the process, and produces much more attractive booklets. Since the database was initially developed in WordPerfect 5.1 ("WP") as a "mail-merge" application, we simply made some adapta- tions to that process to utilize 4Book's superior booklet format- ting and paper handling. The database (the "secondary" file) is merged with a file (the "primary" file) to produce the desired layout. Because 4BOOK requires that its input be in ASCII format, while WP files are in binary format, we "print" using the DOS Text printer driver which is supplied on your WP printer driver diskettes (see your WP manual for more information). Note: This printer must be set up before you start the mail merge. Immediately following the merge operation--do not F7(Save) the file--press Shift-F7(Print), S(Select). Highlight the DOS Text Printer and press E(Edit) then P(Port) then O(Other). Now type in the name of the ASCII file you'll use with 4BOOK (we use FRIENDS.TXT) and press Enter. Now, press F7(Exit) successively ────────────────────────────────────────────────────────────────────── 30 4Print 4.1 Addendum until you return to the merged document. Be sure to S(Select) the DOS Text Printer as you exit. Now, when you print the merge file, the output will be sent to a pure ASCII file on your default directory. Exit WP without F7(Sav)ing. (Remember: Restore all the options you changed under ShiftF7(Print) before you try to use WP again!) We use a configuration file that sets up 4Book to make a standard cover and enters other information we always want to be included. The boiler-plate file is an ASCII file called FRIENDS.CFG. (Be sure to disable 4BOOK.CFG with the -nocfg option if it contains any unwanted options.) Here is what's in FRIENDS.CFG: FRIENDS.CFG ============================================== .options -bcBook -bcNoFooter -bcSunrise -bt"OUR//NEIGHBORS" .front bottom center block CONFIDENTIAL Please do not distribute This directory is for the EXCLUSIVE USE of the residents of OUR NICE VILLAGE .back inside center block ╒═════════════════════════════╕ │ Please forward additions, │ │ updates and corrections to: │ │ │ │ The Folks │ │ 1234 Mugwump Circle │ │ 49'er City, CA 44444 │ │ (123)456-7890 │ ╘═════════════════════════════╛ .blank pages, top center ┌───────────────────────────────────┐ │ Notes │ └───────────────────────────────────┘ .text ============================================== We call 4Book from a batch file so that command line entries are always correct. Using DOS variables in the batch file, we can change the number of copies to print and other information. ────────────────────────────────────────────────────────────────────── Real Life 4Book Example 31 Here's the batch file: FRIENDS.BAT ============================================== 4book friends.txt +friends.cfg %1 %2 %3 ============================================== The batch file calls 4Book, which opens FRIENDS.TXT and prints out the best looking Village Association Telephone Book, anywhere. To be sure, there are a lot of steps, but they are really very straight-forward once you've done them. This approach combines the power of WordPerfect's mail merge feature, and its excellent for- matting capabilities, with the slick booklet printing features of 4Print and 4Book. Ron VanAbrahams CIS 76414,270 ────────────────────────────────────────────────────────────────────── 32 4Print 4.1 Addendum Appendix J ────────────────────────────────────────────────────────────────────── 4Shell and 4Script 4Shell is a Microsoft Windows application written by ZPay Payroll Systems which will control and operate 4Print and 4Book under Windows, providing an easy-to-use menu interface familiar to Windows users. If you ordered the 4Print Windows Version from Korenthal Associates, you received separate documentation for 4Shell. You can also order 4Shell as a separate product from either Korenthal Associates or ZPay Payroll Systems. Please call for details. 4Script is a PostScript version of 4Print/4Book currently under devel- opment at Korenthal Associates. We are planning to offer special prices to 4Print customers who wish to use 4Script on their PostScript printers. Please call for availability and price. ────────────────────────────────────────────────────────────────────── 4Shell and 4Script 33